home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / bbsdoors / ccdor300.zip / CCDOOR.DOC < prev    next >
Text File  |  1993-03-23  |  19KB  |  513 lines

  1.  
  2.  
  3.  
  4.  
  5.                 Credit Card Membership Registration Door v3.00
  6.                  Copyright (C) 1989, 1993 FeatherNet Software
  7.  
  8.  
  9.  
  10.  
  11.  
  12. Introduction
  13. ------------
  14.    CCDOOR is for the sysop of a pcboard v14 or later bbs who uses a paid
  15.    subscription for user access. CCDOOR will take the information from the
  16.    user, decide if it meets the required criteria, update the USERS file
  17.    with the new security level and subscription date (if desired), and add
  18.    all the Q's & A's to a specified file.
  19.  
  20.    CCDOOR utilizes the following to ensure valid information is submitted.
  21.    (1) Phone # Trash file
  22.    (2) Card # Trash File
  23.    (3) Expiration Date limiting (36 Months)
  24.    (4) Repetitous key trapping
  25.    (5) 3 Major errors allowed
  26.    (6) MOD 10 card number verification scheme
  27.  
  28.   The door should work on other bbs's as well. It will update the pcboard users
  29.   file if the sysop elects. This may be a problem non-pcb sysops can live with.
  30.   It does get the user's information and save it in a log file and prints both
  31.   a hard coded report and a sysop definable report.
  32.  
  33.   Note: Version 2.14 added a dos errorlevel of 1 when ccdoor terminates
  34.         normally after saving the report(s).  An errorlevel of 0 upon
  35.         termination of CCDoor means the user either made too many errors
  36.         or chose not to complete the door script.
  37.  
  38.  
  39.  
  40.  
  41.  
  42.                                 Running The Program
  43.                                 -------------------
  44.  
  45.   Setting up "CCDOOR" can be accomplished in a few minutes. Do not think of
  46.   this as being complex and it will not be. Follow the below guide to the
  47.   letter and you will have no problems.
  48.  
  49.  
  50.  
  51. 1. I recommend you make a sub directory for CCDOOR to operate from. You may
  52.    place it anywhere on your system, however.
  53.  
  54. 2. Use PKUNZIP.EXE to extract the files into the chosen directory.
  55.  
  56. 3. Edit the configuration file to suit your system's defaults. If you are
  57.    networking or otherwise using more than one node, ensure a seperate
  58.    configuration file (with a discrete filename) is made for each node.
  59.  
  60. 4. Make a batch file to run the door from the bbs. Use my example as a guide.
  61.  
  62. 5. Construct a TRASH file for card numbers you know are bad and place the
  63.    numbers in them. CCDOOR will check for bad numbers AFTER the user enters
  64.    and verifies the card number. If a forbidden number is used, the user is
  65.    Immediately logged off and the door returns to pcboard for wrap-up.
  66.  
  67. 6. Construct a TRASH file for illegal Phone Numbers.
  68.    CCDOOR will check for bad numbers AFTER the user enters his phone #.
  69.    If an illegal number is used, the user is either returned to the Phone #
  70.    prompt or Immediately logged off and the door returns to pcboard for wrap-up.
  71.  
  72.  
  73.                 Using User's Responses to Write a 'Custom' Report
  74.                 -------------------------------------------------
  75.  
  76.         In response to several requests for more flexibility with the
  77.         report ccdoor writes, I have taken action on the matter and have
  78.         added a 'Custom' report option.
  79.  
  80.         The report will utilize the responses from users and the sysop
  81.         will specify which fields to use and which terminator to use at the
  82.         end of each field in the report ((1) CRLF, (2) Comma & Space,
  83.         (3) two spaces, or (4) enclosing the field in quotes and
  84.         separating each field by a comma
  85.  
  86.         The fields Usable in the custom report and their respective
  87.         numbers are:
  88.  
  89.         (1) Letter Code of Credit Card selected (A, M, D, V, O)
  90.         (2) Name User entered as 'Listed on Card'
  91.         (3) Street Address
  92.         (4) City user is from
  93.         (5) State or Province user is from
  94.         (6) Zip or Postal Code
  95.         (7) Card number entered
  96.         (8) Unnecessary (Same a #7. Used for continuity)
  97.         (9) Card Expiration Date
  98.        (10) Membership Option
  99.        (11) Telephone Number
  100.        (12) User's Name in bbs USERS file
  101.        (13) The time when the report was written (HH:MM)
  102.        (14) The date when the report was written (DD/MM/YY)
  103.  
  104.  
  105.         If you DO NOT want to write a 'Custom' report, place a ZERO '0' in
  106.         the .cfg file on the line stating the number of fields to use
  107.         in the 'Custon' report and make no further entries pertaining to
  108.         the 'Custom' report.
  109.  
  110.         If you ARE going to specify a 'Custom' report follow the guide in the
  111.         sample .cfg file below.
  112.  
  113.  
  114.  
  115.  
  116. Note:
  117.  
  118. Below is MY actual configuration file for v3.00. It is followed by a detailed
  119. description of each entry.
  120.  
  121.  
  122. Sample of REAL Configuration File   ; I named mine "ccd.cfg" (node 1)
  123. ---------------------------------
  124. The Programmer's Inn
  125. Rooster Pierce
  126. c:\pcb\pcboard.sys
  127. c:\test
  128. c:\test\ron.scr
  129. c:\test\ron.ans
  130. c:\pcb\main\users
  131. c:\pcb\main\pwrd
  132. c:\test\cctrash
  133. 10
  134.  
  135. Effective May 1, 1989, there are 2 Membership Options available, @FIRST@.
  136. The Full One Year Membership includes access to ALL MIDI Conferences,
  137. including the Patch and Sample Libraries.
  138.  
  139. The Limited 3 Month Membership DOES NOT include access to the
  140. Patch and Sample Libraries.  Access to those libraries is available
  141. with the One Year Membership ONLY.
  142.  
  143. What is your Membership Option ( 1 = 1 Year/$95  2 = 3 Months/$30 )
  144. 2
  145. 80, 12
  146. 60, 3
  147. 0
  148. c:\test\ccinfo
  149. c:\test\ccphone
  150. 30
  151. 1
  152. 0
  153. 00000
  154. VMAOD
  155. 1
  156. What is your city
  157. What is your state or province
  158. What is your zip code or postal code
  159. Your City
  160. Which State or Province
  161. Your Zip or postal code
  162. Y
  163. 1
  164. c:\test\ccreport
  165. 1
  166. 5
  167. c:\test\cclabel, 1
  168. 2,1
  169. 3,1
  170. 4,1
  171. 5,1
  172. 6,0
  173. &H3F8
  174. 4
  175.  
  176.  
  177. Explanation of Above Configuration file
  178. ---------------------------------------
  179.  
  180. The Programmer's Inn  ;BBS name
  181. Rooster Pierce        ;Sysop name
  182. c:\pcb\pcboard.sys    ;Where to find PCBoard.sys (v2.13 and newer ignore it)
  183. c:\test               ;Where to find the ccdoor menu files
  184. c:\test\ron.scr       ;Full path/name of the script to use
  185. c:\test\ron.ans       ;Full path/name of the script answer file to write to
  186. d:\pcb\main\users     ;Path/name of the pcboard USERS file
  187. d:\pcb\main\pwrd      ;Path/name of the pcboard pwrd file (See Below!!)
  188. c:\test\cctrash       ;Full Path/Name for the Trash File (read only)
  189. 12                    ;Number of Lines to read (includes the membership
  190.                       ;question). Any blank line is counted. This is ONLY for
  191.                       ;the membership question!!!
  192.  
  193. There are 12 total lines in the above configuration file describing the
  194. membership options available on the bbs. The last line (line 12) MUST
  195. be the actual question asking which membership option a user desires.
  196.  
  197.  
  198.  
  199.  
  200.  
  201. What is your Membership Option ( 1 = 1 Year/$95  2 = 3 Months/$30 )
  202. 2 ----------------------;Number of membership levels to use.
  203. 60, 12 ---------------- ;The access level and number of months for option 1
  204. 61, Unlimited-----------;The access level and Text to disable exp. updating
  205.                         ;If "00-00-00" follows the new access level the
  206.                         ;NEW expiration date will be 00-00-00. (000000)
  207. 1 -----------;Enter a "1" if CCDOOR IS TO UPDATE the users file or a "0" if NOT
  208. c:\test\ccinfo ---------;Full Path/Name of a text file with anything you wish
  209. c:\test\ccphone --------;FULL Path/Name of the Phone Trash file.
  210. 30 ---------------------;Number of lines in the script header (1-199).
  211.  
  212. 1 --------------------- ;Place a "0" here to logoff users with more than 3
  213.                         ;illegal/incorrect responses or a 1 if you want them
  214.                         ;returned to the bbs
  215.  
  216. 0       ;This is the security level required to access this door. Useful
  217.         ;on systems with more than one TYPE ccdoor script.
  218.  
  219. 00000   ;Registration Number. You get this from the author when you register
  220.         ;the door.
  221.  
  222. VMAOD   ;Indicates this bbs wil accept Visa, Mastercard, American Express,
  223.         ;Optima, and Discover
  224. 1       ;A "1" here tells ccdoor NOT to CHANGE the access level of a user
  225.         ;whose access level is already HIGHER than the level given users
  226.         ;successfully completing the CCDoor registration procedure.
  227.         ;Otherwise place a "0" here
  228.  
  229.  
  230.  
  231. What is your city                    ;The first three lines are for the 
  232. What is your state or province       ;questions themselves. leave enough room
  233. What is your zip code or postal code ;for the answer on the same line!
  234.  
  235. Your City                            ;These three lines are for the review of
  236. Which State or Province              ;answers. Limit these to 27 characters.
  237. Your Zip or postal code              ;
  238.  
  239.  
  240. Y               ;Place a "Y" here if you want ccdoor to compute the NEW
  241.                 ;expiration date from "today's" date. Any other letter will
  242.                 ;cause ccdoor to use the expiration date in pcboard's users
  243.                 ;file.
  244.  
  245. 1                       ;Put a "1" here if you wish a report to be
  246.                         ;written to a specified file name. A sample
  247.                         ;'hard coded' report format is listed below
  248.  
  249. c:\test\ccreport        ;Path/name of "report" text file.(if any)
  250. 1                       ;a "1" signifies you are running pcboard
  251.                         ;v14.5 or greater. Use a "0" otherwise
  252.  
  253. 5                       ;Number of lines in 'Custom' report (0 if none)
  254. |----------------------------------------------------------------------------|
  255. |  Note: The following lines pertaining to the 'Custom' report are to be     |
  256. |        included in the .cfg file ONLY if you have entered a number greater |
  257. |        than zero in the entry above. If you DO NOT want to write a 'Custom'|
  258. |        report, place a ZERO '0' in the above location in your .cfg file(s) |
  259. |        and make no further entries pertaining to the 'Custom' report.      |
  260. |        It is likely that in a future release the .cfg file will be expanded|
  261. |        and you must follow the syntax to prevent problems.                 |
  262. |----------------------------------------------------------------------------|
  263. c:\test\cclabel, 1      ;Path Name of file to write 'custom' report to and
  264.                         ;a '1' if you wish a blank line added after each report
  265.                         ;is written (otherwise place a zero here)
  266.  
  267.      Note: The above 'sample' ccd.cfg file will use 5 fields from the user's
  268.            responses in the 'Custom' report. The first number in each entry
  269.            is the FIELD to write and the second is the 'terminator' code.
  270.            The terminator codes and explanations are:
  271.  
  272.      0 = CRLF (Carriage Return and Linefeed
  273.      1 = ", " (Comma & Space)
  274.      2 = "  " (Two Spaces)
  275.      3 = Enclose the field in Quotes and terminate it with a comma
  276.  
  277. Note: If you are using a 'Custom' report, each field entry must be separated
  278.       by a comma in the .cfg file as listed in the sample .cfg file above and
  279.       in the below explanation.
  280.  
  281. 2,1             ;Writes field #2 terminated by a comma and space
  282. 3,1             ;Writes field #3 terminated by a comma and space
  283. 4,1             ;Writes field #4 terminated by a comma and space
  284. 5,1             ;Writes field #5 terminated by a comma and space
  285. 6,0             ;Writes field #6 terminated by a Carriage Return/Linefeed
  286. ------------------------------------------------------------------------------
  287. &H3F8           ; Sample Serial Port Address (COM 1)
  288. 4               ; Sample IRQ # to use (COM 1)
  289.  
  290.       Note that you MUST include the port address and IRQ if you are using
  291.       non-standard comm port adddresses.
  292.  
  293.  
  294. NOTICE: Note the Feb. 1990 addition to the config file above - the addition of
  295.         the location of PCBoard's "PWRD" file. This is a flag to update the
  296.         PCBoard.sys file with the user's NEW time allowed after successfully
  297.         completing a script. Leave this line EMPTY if the PCBoard.sys file is
  298.         NOT to be updated.
  299.  
  300.  
  301. Sample 'Hard Coded' report:
  302.  
  303. SYSOP                   ;User's Name in USERS file
  304. 415-967-3484            ;Phone Number
  305. 07-28-90                ;Today's date
  306. 08:43                   ;Current time
  307. RONNIE L. PIERCE        ;Name on Credit Card
  308. 810 -F VERNON CIRCLE    ;Street Address
  309. MTN VIEW                ;City
  310. CA                      ;State or Province
  311. 94043                   ;Zip or Postal Code
  312. V                       ;First letter of Credit Card type (V,M,A,D)
  313. 4123456789012345        ;Credit Card Number
  314. 11/90                   ;Card expiration date
  315. 1                       ;Membership option #
  316.  
  317. You MUST remember to make a seperate .cfg file for each node.
  318.  
  319. 7. Make a batch file to run the door. If more than one node, ensure a batch
  320.    file is made for each node.
  321.  
  322. PCBoard Door Batch File for CCDOOR
  323. ----------------------------------
  324. c:                                   ; CHDIR to directory where CCDOOR .EXE
  325. cd\pcb                               ;  file is located
  326. CCDOOR ccd.cfg c:\pcb\pcboard.sys    ; Command line to run CCDOOR
  327. cd\pcb                               ; CHDIR back to PCBoard home directory
  328. BOARD
  329.  
  330.  
  331.  
  332. To run in local (command-line) mode, enter the command line as follows:
  333.  
  334. CCDOOR ccd.cfg c:\pcb\pcboard.sys /L
  335.  
  336.  Replace "ccd.cfg" with the name of your actual .cfg file for the node's
  337.  ccdoor.
  338.                                 Notes
  339.                                 -----
  340.  
  341. o You may use text instead of a number for the membership options in the .cfg
  342.   file. If a text string is used the expiration date updating for that
  343.   membership option is effectively disabled and the "review" of answers will
  344.   display the text entered instead of a # of months.
  345.  
  346. Sample from my .cfg file:
  347. ---------------------------
  348. What is your Membership Option ( 1 = 1 Year/$95  2 = Usage/$$$.¢¢ )
  349. 2
  350. 80, 12
  351. 60, Usage
  352. ----------------------------
  353. o Will be considering a routine to output the subscription information in
  354.   a custom report format if anyone has ideas on this.
  355.  
  356.  
  357.  
  358. Script File Info
  359. ----------------
  360.  
  361.    ***  The Following Questions are "Hard-Coded" into CCDOOR  ***
  362.  
  363.  
  364. (1)  a$="Which credit card will you be using (Visa/MC/Discover/AMEX?)"
  365.  
  366.      ********************************************************************
  367.      *** Above question is not exactly hard-coded. Sysop may select   ***
  368.      *** the cards he wishes to support. Only those will be displayed ***
  369.      *** in the question to the user.                                 ***
  370.      ********************************************************************
  371.  
  372. (2)  a$="What is your FULL NAME as it appears on the credit card?"
  373.  
  374. (3)  a$="Street Address:"
  375.  
  376. (4)  a$= CUSTOM: "What is your city"
  377.  
  378. (5)  a$= CUSTOM: "What is your state or province"
  379.  
  380. (6)  a$= CUSTOM: "What is your zip or postal code"
  381.  
  382. (7)  a$="Credit Card number (xxxx-xxxx-xxxx-xxxx format)?"
  383.  
  384. (8)  a$="Please repeat the number for verification."
  385.  
  386. (9)  a$="Expiration date (mm/yy format)?"
  387.  
  388.  
  389.  
  390. Edit your script file as required for pcboard. CCDOOR ONLY supports the @FIRST@
  391. macro. Look at the file "RON.SCR" to see how to begin the script.
  392.  
  393.  The script header may now contain up to 199 lines. A "More" prompt occurs
  394.  after 22 lines are displayed.
  395.  
  396. Note that in the script file, precede the question asking the telephone number
  397. with a "#" as done in "ron.scr". This Is necessary to perform the phone number
  398. verification. Also, precede the question asking if a user really wants to
  399. process the membership order with a "&". Again this is necessary for proper
  400. program operation.
  401.  
  402.  
  403.  
  404.                               Software License Agreement
  405.                               --------------------------
  406.  
  407.             **  You are free to copy and distribute CCDOOR provided:  **
  408.  
  409.               **  No fee is charged for use, copying or distribution  **
  410.  
  411.                     **  It is not modified in any way  **
  412.  
  413.  
  414.                                     Registration
  415.                                     ------------
  416.  
  417.  ***************************************************************************
  418.  ****   Removes Encrypted "UNREGISTERED" shareware notice and displays  ****
  419.  ****   your bbs name in its place!                                     ****
  420.  ***************************************************************************
  421.  
  422.      You should register this product if used for more than a 30 day "trial"
  423.      period. Registration will get you free upgrades and make available to
  424.      you any future door product or BBSware from FeatherNet and Ron Pierce.
  425.  
  426.      Registration fee:  $30.00 for a single Bulletin Board System.
  427.  
  428.      Clubs and user groups may charge a nominal fee not to exceed ($5.00) for
  429.      expenses and handling while distributing CCDoor.
  430.  
  431.  
  432.  
  433.                       Credit Card Door v3.00 Licensing Agreement
  434.  
  435.                          
  436.                                                         Date:________________
  437.  
  438.  
  439.      From: _________________________________
  440.      
  441.      To:   Ron Pierce, FeatherNet SoftWare
  442.  
  443.      Subj: Credit Card Door Software License Application
  444.  
  445.  
  446.      I, _________________________________, 
  447.      
  448.      hereby apply for a license to operate the Credit Card Door (CCDOOR).
  449.  
  450.      I understand the registration fee allows me to free upgrades for
  451.  
  452.      one year (Except for any Shipping/Download Costs).
  453.  
  454.           Further, I will have continuous use of the FeatherNet SUPPORT BBS
  455.  
  456.      for problems, questions, and for just staying in touch.
  457.  
  458.     Enclosed is my Registration fee.
  459.  
  460.  
  461.     Note: Make check or money order payable ONLY in US Dollars.
  462.  
  463.                               
  464.  
  465.  
  466.                            Signed: ___________________________________
  467.  
  468.  
  469. Enter your bbs name EXACTLY as you will place it in the configuration file.
  470.  
  471.  
  472.  
  473. _________________________________________________
  474.  
  475.  
  476.                Check appropriate Block
  477.  
  478.            [ ] $30.00  Initial Registration Fee and free BBS Support
  479.  
  480.  
  481.  
  482.         Mail registration to:
  483.  
  484.                 Ron Pierce
  485.                 2022 Wall St.
  486.                 Butte, MT.  59701
  487.  
  488.  
  489.  
  490.                               Disclaimer
  491.                               ----------
  492.  
  493.      Your acceptance and use of this program implies that you accept FULL
  494.      responsibility for any damage or loss to yourself, your property, and
  495.      your dog - if you have one.
  496.      Every effort has been made to ensure no dangerous bugs are in the
  497.      program.
  498.  
  499.      I, Ron Pierce,  hereby disclaim all warranties relating to this software,
  500.      whether express or implied, including without limitation any implied
  501.      warranties of merchantability or fitness for a particular purpose. I
  502.      will not be liable for any special, incidental, consequential, indirect
  503.      or similar damages due to loss of data or any other reason, even if I
  504.      have been advised of the possibility of such damages.  In no event
  505.      shall MY liability for any damages ever exceed the price paid for the
  506.      license to use this software, regardless of the form of the claim.
  507.          The person using the software bears ALL RISK as to the quality and
  508.      performance of the software.
  509.  
  510.  
  511.  
  512.  
  513.